# cmus-scripts 
## A bunch of cmus-related scripts.

[Cmus](https://cmus.github.io/) is my favourite audio player at the moment.  It's cross-platform,
lightweight, it runs in the terminal and it's just brilliant. I use it on all of my Linux PCs.
It even works on Windows - under Cygwin of course!   

This repository contains some scripts and snippets that I use to control cmus and/or display
now-playing track information.  

------------------------------------------

### Nowplay
The main script in this repository is called [nowplay](scripts/nowplay).  All
nowplay does is determine whether cmus is running and the state of the player.
If cmus is playing or paused - current track information is displayed.  And that
is it!  

It can also be used in conjunction with other tools (e.g. conky) to display
now playing track information from cmus. (see the section below for more on this)

To install nowplay:  
Simply download the [nowplay](scripts/nowplay) script from this repository and
save it somewhere on your path.  I have my copy in my personal bin directory
(~/bin). But you could put it anywhere in your path.


-----------------------------------  
  
### Additional scripts and snippets:
Other than nowplay itself - the remaining content in the scripts directory are all example uses of nowplay,
or are snippets from config files from my Linux laptop which use nowplay:

All scripts can be put somewhere in your path and used in conjunction with 
nowplay.  Feel free to download them individually from here, or clone the entire repo and 
pick and choose what to install. 

See [SCRIPTS.md](scripts/SCRIPTS.md) for more details on the contents of the scripts
directory.  

-----------------------------------------------  
  
### Did you say CMUS runs on Windows??  
Yup, that's right.  Cmus can be built and ran on Windows under Cygwin.  It's not
exclusive to Unix-like OSes.  

At my current job, I have to use Windows and have no choice over that.  So I run
cmus in a cygwin terminal in a tmux session on my work PC and it runs really
well.  The bash aliases and the nowplay script (in the scripts directory) also
allow me to control playback from any cygwin terminal window.  

The windows directory in this repository contains some additional .bat files,
which I have assigned to some hot-keys, allowing me to control cmus from the
desktop on my Windows PC at work.  

see [WINDOWS.md](windows/WINDOWS.md) for how to install the .bat files and
assign hot-keys to them under Windows.  

------------------------------------------------

### Clone this repo:
`git clone https://notabug.org/JasKinasis/cmus-scripts.git`  

